Implementation Plan for Post Revision Commands

• Explore repository structure and understand existing patterns
• Create Post_Revision_Command.php file with three commands:
  • wp post revision restore <post_id> - Restore a revision with the given ID
  • wp post revision diff <from> <to> - Compare/diff two revisions with CLI-friendly colored output
  • wp post revision prune [<post-ids>...] [--latest=<limit>] [--earliest=<limit>] - Delete old revisions
• Register the command in entity-command.php
• Add command to composer.json commands list
• Create Behat feature tests for all commands
• Address all code review feedback
• Fix incomplete test scenario for diff between two revisions
• Replace HTML diff output with CLI-friendly colored output
• All code quality checks passing ✓

Commands

wp post revision restore <revision_id>

Restores a post to the specified revision using WordPress's native wp_restore_post_revision().

wp post revision restore 123
# Success: Restored revision 123.

wp post revision diff <from> [<to>] [--field=<field>]

Compares revision content using CLI-friendly colored diff output. Auto-detects parent post when <to> is omitted.

# Compare two revisions
wp post revision diff 123 456

# Compare revision with current post
wp post revision diff 123

# Compare specific fields
wp post revision diff 123 456 --field=post_title

wp post revision prune [<post-ids>...] [--latest=<limit>] [--earliest=<limit>]

Deletes old post revisions while keeping a specified number of latest or earliest revisions.

# Delete all but the latest 5 revisions for post 123
wp post revision prune 123 --latest=5

# Delete all but the latest 5 revisions for all posts
wp post revision prune --latest=5 --yes

# Delete all but the earliest 2 revisions for posts 123 and 456
wp post revision prune 123 456 --earliest=2

Features:

• If <post-ids> is provided, flags apply individually to those posts only
• If <post-ids> is not provided, flags apply to all posts individually
• Requires confirmation when processing multiple posts (use --yes to skip)
• Must specify either --latest or --earliest flag (cannot use both)
• Provides detailed feedback on number of revisions deleted per post

Diff Output

The diff command displays changes with color coding:

• Red lines with - prefix = Deleted lines
• Green lines with + prefix = Added lines
• Default color with prefix = Unchanged lines
• Yellow header lines = Revision metadata (title, date, ID)

Example output:

--- Original Post (2024-01-01 12:00:00) - ID 123
+++ Modified Post (2024-01-02 13:00:00) - ID 456

  Line 1
- Line 2
+ Line 2 modified
  Line 3

Supports 15 post fields: post_title, post_content, post_excerpt, post_name, post_status, post_type, post_author, post_date, post_date_gmt, post_modified, post_modified_gmt, post_parent, menu_order, comment_status, ping_status.

Implementation

• src/Post_Revision_Command.php: Command class with restore, diff, and prune subcommands
• entity-command.php: Registers post revision namespace
• composer.json: Adds command entries for autocompletion
• phpcs.xml.dist: Excludes new command from prefix rules
• features/post-revision.feature: 12 comprehensive test scenarios covering all commands

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.